package org.example.aienglishapp.mapper.login;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.example.aienglishapp.entity.login.Permission;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Set;

/**
 * 权限映射接口。
 *
 * 该接口定义了与权限相关的数据库操作方法，并使用 MyBatis 进行持久层的交互。
 *
 * @author xlj
 * @since 2024-10-1
 * @version 1.0
 */
@Mapper
@Repository
public interface PermissionMapper {

    /**
     * 根据权限名称查询权限信息。
     *
     * @param permissionName 权限名称
     * @return 返回对应的权限对象，如果未找到则返回 null
     */
    Permission findByPermissionName(@Param("permissionName") String permissionName);

    /**
     * 根据角色ID查询该角色所拥有的所有权限。
     *
     * @param roleId 角色ID
     * @return 返回一个包含该角色所有权限的列表
     */
    List<Permission> findPermissionsByRoleId(@Param("roleId") Long roleId);

    /**
     * 查询系统中所有的权限。
     *
     * @return 返回一个包含所有权限的列表
     */
    List<Permission> findAllPermissions();

    /**
     * 根据权限ID查询权限信息。
     *
     * @param id 权限ID
     * @return 返回对应的权限对象，如果未找到则返回 null
     */
    Permission findById(@Param("id") Long id);

    /**
     * 根据权限ID列表查询多个权限。
     *
     * @param permissionIds 权限ID列表
     * @return 返回一个包含指定ID权限的列表
     */
    List<Permission> findPermissionsByIds(@Param("permissionIds") List<Long> permissionIds);

    /**
     * 更新权限信息。
     *
     * @param permission 要更新的权限对象
     * @return 返回受影响的行数
     */
    int updatePermission(Permission permission);

    /**
     * 插入权限和角色之间的关联关系。
     *
     * @param permissionId 权限ID
     * @param roleId       角色ID
     */
    void insertPermissionRole(@Param("permissionId") Long permissionId, @Param("roleId") Long roleId);

    /**
     * 删除权限和角色之间的关联关系。
     *
     * @param permissionId 权限ID
     * @param roleId       角色ID
     */
    void deletePermissionRole(@Param("permissionId") Long permissionId, @Param("roleId") Long roleId);
}